FMS Event Data Group
The "FMS Event Data" (FmsEvent) data group is used to send event data to the FMS. It gets its data ffrom a support data group identified by attribute type dgStruct="Audit". The support data group must be instantiated before polling the "FMS Event Data" (FmsEvent) data group.
Events are identified by signal string names. A string signal may resolve to an FMS item for a specific meter run or for the field device (which includes all of its meter runs). Mapping between event data group elements and FMS occurs within the eventItems section of fmsMaps in the device template file. If a deid is included in the alarmItems section of fmsMaps, the data group containing the specified deid must be instantiated in order for the FMS data group to be able to interpret the named element.
An ordinal may be specified in the device template file to associate an event with a particular run number.
Note: In the supportDg list in the device template file for FMS data groups, if you want to include a data group that is not included on the FMS ordinal, that data group must be on ordinal 0.
When an event occurs, data groups in the device template file are searched for a data group element matching the signal string. Next, the fmsMaps element of the device template file is searched for an FMS item reference to that data group element. If no FMS item is found, the event is recorded as device specific. Set the omitUnmpappedEvents attribute to true to omit unmapped events from the "FMS Event Data" data group. See also FMS Event Data Items.
In FMS, there are two commands used to access data for FMS events:
- Request Data (date-based request)
- Request New Data (token-based request)
Note: When running the Request New Data command, set the Optimization setting on the Data Group Properties dialog box for the "Audit Trail" (Audit) data group to Get latest: read and purge.
For more information, see the following subsections:
For more information about working with device template files, see Device Template Files.
Example
|
<FmsEvent niceName="FMS Event Data" baseOrd="1" maxCnt="4" omitUnmappedEvents="false"> <supportDg> <Audit required="true" /> </supportDg> <dgElements/> </FmsEvent> |
Structure and Components
|
<!-- By default, signal strings that are not mapped to FMS eventItems are recorded as device-specific events. Set omitUnmappedEvents to true to override this behavior. --> <FmsEvent niceName="FMS Event Data" omitUnmappedEvents=""> <supportDg> <supportDg /> </supportDg> <dgElements/> </FmsEvent> |
